home *** CD-ROM | disk | FTP | other *** search
/ Danny Amor's Online Library / Danny Amor's Online Library - Volume 1.iso / html / faqs / faq / apple2 / part1 next >
Encoding:
Text File  |  1995-07-25  |  34.6 KB  |  764 lines

  1. Subject: comp.sys.apple2 - Frequently Asked Questions (and answers) part 1 of 2
  2. Newsgroups: comp.sys.apple2,news.answers,comp.answers
  3. From: dmag@caen.engin.umich.edu (Dan DeMaggio)
  4. Date: 7 Nov 1994 04:53:18 GMT
  5.  
  6. Archive-name: apple2/part1
  7. Last-modified: 08 Sep 1994
  8. Version: 4.01
  9.  
  10. Table of Contents
  11. ----- Part I
  12. Q#1    What's a FAQ?
  13. Q#2    How do I get to comp.sys.apple2 and what is it?
  14. Q#3    How do I get files off the net?
  15. Q#4    Where can I get Apple II software on the net?
  16. Q#5     How can I find a particular program?
  17. Q#6    What archivers do I need to know about?
  18. Q#7     BinSCII
  19. Q#8     ShrinkIt and NuFX archives
  20. Q#9     Executioner
  21. Q#10    Apple Archive Format (aaf)
  22. Q#11    Net standard formats
  23. Q#12    A quick note about ProDos filetypes
  24. Q#13   What do the file extensions mean?
  25. Q#14   How do I tell what kind of file this is?
  26. ------ Part II
  27. Q#15   What is an Apple II?
  28. Q#16    The Apple I
  29. Q#17    The Apple ][ and Apple ][+
  30. Q#18    The Apple //e
  31. Q#19    The Apple //C and IIC+
  32. Q#20    The Laser 128EX
  33. Q#21    The Apple IIGS
  34. Q#22    The Apple ][e Emulation Card
  35. Q#23   Some Common Questions (with answers!)
  36. Q#24    Info about A2's:
  37. Q#25     What is 8 bit and 16 bit?
  38. Q#26     How can I tell what version my computer is?
  39. Q#27     What programming languages are available for the Apple ][?
  40. Q#28    Adding Hardware:
  41. Q#29     Can the Apple II connect to SCSI devices?
  42. Q#30     Can I use Macintosh Monitors or 3.5" drives with my ][?
  43. Q#31     Can I hook up a LaserWriter, DeskJet, etc to my Apple //e?
  44. Q#32     Can I hook up a LaserWriter, DeskJet, etc to my Apple IIGS?
  45. Q#33     Can I hook up a scanner up to my //e? Can it do OCR?
  46. Q#34     Can a Disk ][ be used on a GS smartport?
  47. Q#35     What's the scoop on the new HD 3.5" drive?
  48. Q#36     I want a Y-adapter for my GS keyboard.
  49. Q#37    File Transfer:
  50. Q#38     How can I transfer stuff to/from and IBM/Mac?
  51. Q#39     File transfer: Apple //e ---> Macintosh
  52. Q#40     File transfer: Apple //e <--- Macintosh
  53. Q#41     File transfer: Apple //e ---> IBM
  54. Q#42     File transfer: Apple //e <--- IBM
  55. Q#43     File transfer: Apple IIGS ---> Macintosh
  56. Q#44     File transfer: Apple IIGS <--- Macintosh
  57. Q#45     File transfer: Apple IIGS ---> IBM
  58. Q#46     File transfer: Apple IIGS <--- IBM
  59. Q#47     What's the CTI Drive?
  60. Q#48     How about hooking up cheap IDE Hard Drives?
  61. Q#49     How do I USE stuff I have transferred to/from an IBM/Mac?
  62. Q#50     How do I get cool Mac Icons and fonts onto my GS?
  63. Q#51     What programs are there for conversion of graphic images?
  64. Q#52     I have an old CPM / PASCAL / DOS 3.3 disk.  How do I get it into ProDos?
  65. Q#53     How do you copy from a 5.25" disk to 3.5" disk?
  66. Q#54    Strange problems:
  67. Q#55     How do I get out of Basic (that little "]" prompt and flashing cursor?
  68. Q#56     What are the problems with GSCII?
  69. Q#57     AppleWorks won't print to my printer.  What gives?
  70. Q#58     My GS control panel keeps resetting to the defaults and/or forgetting the date.
  71. Q#59     I'm getting Error XXX.  What's it mean?
  72. Q#60     Why does my Apple II lose characters when I'm using the modem?
  73. Q#61     Where do I get support for AE boards now that they are closed?
  74. Q#62     Is there a QWK reader for the Apple // E?
  75. Q#63   System 6.0 mini-FAQ
  76. Q#64    Common Problems
  77. Q#65    Tips & Hints
  78. Q#66    If you have a RamFast
  79. Q#67    If you have a Vulcan or AE High Density disk
  80. Q#68    If you have ProSel
  81. Q#69    If you have an AMR 3.5"
  82. Q#70    GSCII+ & HFS Note
  83. Q#71   What to do with an Apple ][?
  84. Q#72     What can you hook up to an Apple ][?
  85. Q#73     What can you do with an Apple ][?
  86. Q#74     What can the //e can "borrow" from other computers?
  87. Q#75     What can the GS can "borrow" from other computers?
  88. Q#76   Resources for the Apple II
  89. Q#77    Apple II Groups
  90. Q#78    Getting Parts & Software
  91. Q#79    Fun hardware add-ons
  92. Q#80    Periodicals & Books
  93. Q#81    Misc Resources
  94. Q#82   General guidelines on How To Troubleshoot
  95. Q#83    General troubleshooting
  96. Q#84    Trouble shooting and good maintenance
  97. Q#85    GS Trouble shooting
  98. Q#86   SCSI
  99. Q#87    Tips on setting up a SCSI system:
  100.  
  101.  
  102. #########################
  103. #  Q#1   What's a FAQ?  #
  104. #########################
  105.  
  106. Hi!  Welcome to the comp.sys.apple2 newsgroup!
  107.  
  108. This article contains the answers to some Frequently Asked Questions (FAQ)
  109. often seen in comp.sys.apple2.  I am posting this article (once every three
  110. weeks or so--but once a week in September) to help reduce the volume in this
  111. newsgroup and to provide hard-to-find information of general interest.
  112.  
  113. I hope it answers some of your questions.  If you have other questions, feel
  114. free to e-mail me.
  115.  
  116.      Dan DeMaggio (dmag@umich.edu)
  117.  
  118. ###########################################################
  119. #  Q#2   How do I get to comp.sys.apple2 and what is it?  #
  120. ###########################################################
  121.  
  122. c.s.a2 is a USENET newsgroup.  USENET posts originate from your local
  123. newsreader and spread to hundreds of thousands of machienes throughout the
  124. Internet, FidoNet, ProLine BBS system, etc. etc.  Please use proper
  125. netetteiquete when posting. (Browse the news.answers newsgroup.)
  126.  
  127. The comp.sys.apple2 groups were created for the discussion of the Apple II
  128. series of computers. They provide a forum for interested people to compare
  129. notes, ask questions, and share insights about Apple IIs. Currently, these
  130. groups include:
  131.  
  132. comp.sys.apple2              - General discussion and questions
  133.                                relating to all Apple //'s
  134. comp.sys.apple2.comm         - Communications and networking related
  135.                                issues
  136. comp.sys.apple2.gno          - Discussion of program GNO/ME for the
  137.                                Apple IIGS (UNIX for the Apple IIGS)
  138. comp.sys.apple2.marketplace  - Buying, selling and promoting Apple //
  139.                                related products
  140. comp.sys.apple2.programmer   - Discussion relating to any aspect of
  141.                                programming the Apple //
  142. comp.sys.apple2.usergroups   - Discussion relating to Apple //
  143.                                usergroups
  144. comp.binaries.apple2         - Public Domain/Shareware Software for all
  145.                                Apple //'s
  146. comp.sources.apple2          - A moderated newsgroup for the posting of
  147.                                Apple // related source code
  148. alt.emulators.ibmpc.apple2   - Discussion relating to the use of Apple //
  149.                                emulation software/hardware on an IBM
  150.                                compatible system
  151.  
  152. If you have e-mail-only access to the Internet, you will find the following
  153. addresses helpful.  Make sure you have a large mailbox and the time to sift
  154. through lots of messages per day.
  155.  
  156. For this:                        Send a message body of "help" to:
  157. ---------------------------      ---------------------------------
  158. Subscribe to C.S.A2              LISTSERV@vm1.nodak.edu
  159.   (BITNET address of above)      LISTSERV@NDSUVM
  160. APPLE2-L archives                LISTSERV@brownvm.brown.edu
  161.   (BITNET address of above)      LISTSERV@BROWNVM
  162. Games from APPLE2-L              LISTSERV@utarlvm1.uta.edu
  163.   (BITNET address of above)      LISTSERV@UTARLVM1
  164. More files via E-Mail            archive-server@plains.nodak.edu
  165.   (BITNET address of above)      FILESERV@PLAINS
  166. Kermit file transfer program      KERMSRV@cuvmb.cc.columbia.edu
  167.   (BITNET address of above)      KERMSRV@CUVMA (BITNET)
  168. Apple /// files                  APPLE3-L@WVNVM.WVNET.EDU
  169.  
  170. Once you are getting c.s.a2 in your mailbox, you may want to post.  Just use
  171. the addresses listed below.  People with direct access to the newsgroups do
  172. not need these, as they can use their news software to post.
  173.  
  174. Post to any newsgroup           group-name@cs.utexas.edu
  175.           OR                    group.name.usenet@decwrl.dec.com
  176.           OR                    group.name@news.demon.co.uk
  177.           OR                    group.name@news.cs.indiana.edu
  178.           OR                    group-name@pws.bull.com
  179.           OR                    group-name@ucbvax.berkeley.edu
  180. Post to comp.sys.apple2         info-apple@apple.com
  181.  
  182.  
  183.  
  184. Comp.binaries.apple2 is a newsgroup used to distribute public domain,
  185. freeware, and shareware Apple II software (executables, pictures, sounds,
  186. etc...).  Software distributed on comp.binaries.apple2 is expected to be a
  187. BinSCII text file containing a ShrinkIt archive. [See later in the FAQ for
  188. information on getting these programs.] ALWAYS include text in the first
  189. message that describes what is in the BSQ file.  Include such things as what
  190. type of computer it runs on and what it does. You may crosspost the
  191. description (only) to comp.sys.apple2.
  192.  
  193. [Public Domain programs may be used and copied freely.  Freeware is the same,
  194. except that the original owner retains the Copyright.  Shareware programs can
  195. be distributed freely, and tried out for free, but if you use it a lot, you
  196. are expected to help pay for it.]
  197.  
  198. Comp.sources.apple2 is a newsgroup used to distribute public domain, freeware,
  199. and shareware Apple II source code.  The posts in comp.sources.apple2 should
  200. be in Apple Archive Format.  Contact jac@paul.rutgers.edu for details.
  201.  
  202. Discussions concerning the software posted in these groups, or the methods of
  203. locating, decoding, or accessing this software, or questions on locating
  204. archive sites of this software, or any OTHER discussions are to be held in
  205. comp.sys.apple2.  If someone DOES either intentionally or accidentally post
  206. to the binary/source groups, please respond only in Email - do not compound
  207. the problem!
  208.  
  209.      Distribution of commercial software is strictly prohibitied.
  210.  
  211. ###########################################
  212. #  Q#3   How do I get files off the net?  #
  213. ###########################################
  214.  
  215. Quick Summary:
  216. Step 1: Make a list of files that you want
  217. Step 2: Get files to your host (a UNIX box or ProLine BBS)
  218. Step 3: Get files to your Apple II
  219. Step 4: Create BINSCII
  220. Step 5: Create ShrinkIt
  221. Step 6: Use BinSCII & Shrinkit to create Shrinkit GS
  222. Step 7: Extract the files you _REALLY_ wanted
  223. Step 1: Make a list of files that you want
  224. 1) You need BINSCII (binscii.exe) and ShrinkIt (shrinkit.3.3.exe.bsc)
  225.    unless you already have them, or know someone who has them.
  226. 2) If you have a GS (and use GS/OS), you will want Shrinkit GS
  227.    (shrinkit.gs.exe) and GSCII (gscii.bsc)
  228. 3) Add any other files you want. Don't try to get everything the
  229.    first time around.  Try one or two test files for starters.
  230.  
  231.   Note: Filenames will vary from site to site. Shrinkit and Binscii
  232.         are usually available on all the Apple II FTP sites.
  233.  
  234. Step 2a: Get files to your host (For ProLine users)
  235. 1) Dial up your host and log in.
  236. 2) I'm not familiar with ProLine, so I'll be vague here. Just go
  237.    into the files section and look...
  238.  
  239.  
  240. Step 2b: Get files to your host (For UNIX, using FTP)
  241. 1) Choose an FTP site from the FAQ
  242. 2) At your UNIX prompt, type "ftp ______" (fill in site name)
  243. 3) At the "Login:" prompt, type "anonymous"s
  244. 4) Type in your e-mail address
  245. 5) Type "bin"
  246. 6) use "cd ____" to get to where the Apple II files are
  247. 7) Locate each file (more "cd ___"'s and "ls" (list files). Also,
  248.    "cd .." will move up a directory.)
  249. 8) use "get ______" to get it
  250. 9) When you are done using FTP, type "quit"
  251. 10) Advanced users may want to run uudecode, uncompress, tar, SciiBin,
  252.    or Nulib on the files before they download them.
  253.  
  254. Step 3: Get files to your Apple II
  255. 1) Find out what file transfer protocols your Apple communications
  256.    package supports. (see below for a list)
  257. 2) On your local comm program, set your file transfer type to Text
  258.    (TXT) or Binary (BIN) depending on what type of file you are
  259.    downloading. If there is an option to "strip incoming linefeeds",
  260.    try turning it on.
  261. 3) Get your host to send you the file.  I don't know about ProLine,
  262.    but UNIX users can use these commands:
  263.    For Z-Modem: "sz ___ ____ ____"  (file names)
  264.    For X-Modem: "sx ____" (one at a time)
  265.    For Kermit:  "kermit", then "put _____" (filename)
  266. 5) If needed, tell your local communications program to Receive. You
  267.    must do this quickly, or the other host will give up trying to
  268.    send the file.
  269. 4) Write down the full pathname of the files you downloaded and where
  270.    you put them. There will be a quiz later.  Pathnames look like
  271.    "/DISK/DIR/FILE.NAME"
  272.  
  273.   Note: If something goes wrong, hit ESC, Ctrl-X or Ctrl-C 3 times.
  274.         If you can't get one protocol to work, try the next one
  275.         down. Z-modem is much faster than the others. You will
  276.         want to find a program that supports it.
  277.  
  278. Step 4: Create BINSCII
  279. 1) After you disconnect, go into Applesoft by starting BASIC.SYSTEM
  280. 2) At the `]` prompt, type 'EXEC ____' (your BINSCII file name)
  281.   Note: If you get ?SYNTAX ERRORs then something went wrong. Try
  282.         looking at the file with a Text Editor.
  283. 3) Type "cat" and look for BINSCII (type 'SYS')
  284. 4) type "-BINSCII" or "-BINSCII.SYSTEM" depending on above
  285.  
  286.   Note: You should get the BINSCII opening screen.
  287.  
  288. Step 5: Create ShrinkIt
  289. 1) If your Shrinkit file ends in ".BSC" then (In BINSCII) type in
  290.    the filename of your ShrinkIt file
  291. 2) Quit BINSCII. Get into AppleSoft again.
  292. 3) Type "EXEC SHRINKIT3.3.XTX" (you may need the full pathname)
  293. 4) Run ShrinkIt with "-SHRINKIT.SYSTEM"
  294.  
  295. Step 6: Extracting everything else
  296. 1) If it's BSQ or BSC, run it through BINSCII
  297. 2) If BINSCII creates a ".SHK" file, or if you download a ".SHK"
  298.    file, then use ShrinkIt on the file.  It's easy to use and it
  299.    doesn't give you the dreaded "FILENAME QUIZ!"
  300.  
  301.  
  302.  
  303. For those who haven't picked a program to download with, here are the biggies:
  304.  When in doubt, buy ProTerm.
  305.  
  306. Program   Comp Emulations     Protocols             Note
  307. ------------------------------------------------------------------------------
  308. ProTerm    E$  PSE, VT-100     Kermit, X,Y,Z-modem  From InSync
  309. Kermit-65  E   VT-100          Kermit, X-modem      Hard to use,Works on ][+
  310. Z-Link     E   VT-100          X-modem              Good.
  311. CommSys    E   none            X-modem              Works on ][+
  312. TIC        E$  VT-100 (+)      X-modem              Small, Scripting.
  313. Agate      E   mono ANSI       X,(Y,Z rec'v only)   Unpacks ZIP, Buggy
  314. ColorTerm  GS  color ANSI      X-modem              Desktop based
  315. MegaTerm   GS  color ANSI      none                 ProDOS 8
  316. ANSITerm   GS$ color ANSI, PSE X,Y,Z-modem          Editor, scrollback, etc.
  317. SnowTerm   GS  VT-100 (+)      none                 Desktop based
  318. FreeTerm   GS  none            X-modem              Desktop based
  319. GenComm    GS  none            none                 Text, Shell Compat.
  320. GSVT       GS  VT-100          none                 Desktop
  321. GTerm      GS  color ANSI      none                 Written in BASIC/ML
  322. Telcom     GS  VT-100, PSE     X, (Y rec'v only)    Shell compat
  323. ----------Key:---------
  324. Key: $ = A commercial program   + = And other obscure ones
  325. Computer:  E = works on GS and //e, GS = only works on GS
  326. See the resources section for where to buy the commercial programs.
  327.  
  328.  
  329.  
  330. All of the non-commercial programs are available on the different FTP sites.
  331. If you don't have a comm program already, your best bet is to have someone
  332. mail you one on a disk.
  333.  
  334. #########################################################
  335. #  Q#4   Where can I get Apple II software on the net?  #
  336. #########################################################
  337.  
  338. Note: For a listing of BBS's, see Mike Shecket's list:
  339.  
  340. FTP: apple2.archive.umich.edu /apple2/misc/textfiles/bbs.list.txt
  341.  
  342. The following is a list of FTP sites with Apple // related files. See "FTP"
  343. for details about using FTP.
  344.  
  345. Site name                    Directory
  346. ---------                    ---------
  347. apple2.archive.umich.edu ($) /archive/apple2
  348. archive.orst.edu             /pub/mirrors/archive.umich.edu
  349. bric-a-brac.apple.com        = ftp.apple.com
  350. brownvm.brown.edu ($) (+)    LISTSERV.193
  351. bull.cs.williams.edu         /pub/AppleII
  352. ?calvin.sfasu.edu             /pub/apple2
  353. cco.caltech.edu ($)          /pub/apple2
  354. ccosun.caltech.edu           = cco.caltech.edu
  355. cs.bu.edu                    /PC/APPLE
  356. cuvmb.cc.columbia.edu        KERMA
  357. f.ms.uky.edu ($)             /pub/appleII
  358. ftp.apple.com                /dts/aii
  359. ftp.cc.utexas.edu            /gifstuff/apple
  360. ftp.hawaii.edu (@)           /incoming/apple2
  361. ftp.uni-kl.de ($)            /pub/apple2
  362. grind.isca.uiowa.edu ($)     /apple2, /unix/apple2
  363. ?headcrash.berkeley.edu       /pub/Apple2
  364. info2.rus.uni-stuttgart.de   /afs/umich.edu/group/itd/archive
  365. isca02.isca.uiowa.edu        = grind.isca.uiowa.edu
  366. iskut.ucs.ubc.ca             /pub/apple (Kermit, BinSCII, unshrinkit)
  367. ?j.cc.purdue.edu              /kermit/appleII
  368. ?jyu.fi                       /pub/apple2
  369. methan.chemie.fu-berlin.de(@) /pub/doc/faq
  370. pindarus.cs.uiuc.edu         /pub/apple2
  371. plains.nodak.edu ($)         /pub/appleII
  372. ?relay.cs.toronto.edu (@)     /pub/lists.1989
  373. slab.slip.uiuc.edu           /apple2
  374. syr.edu                      /software/kermit/appleII
  375. trantor.ee.msstate.edu       /files/appleII
  376. ucrmath.ucr.edu              /PC/apple2
  377. watsun.cc.columbia.edu       /kermit/a
  378. wilbur.stanford.edu          /pub/emulators/apple2/DiskImages/
  379. wuarchive.wustl.edu ($)      /systems/apple2
  380. (+)  Files on brownvm.brown.edu are stored by serial number.  For a human-
  381. readable directory, send e-mail with the text "INDEX APPLE2-L" to
  382. LISTSERV@brownvm.brown.edu.
  383. ($)  This sign marks the "major" sites--those with especially large and
  384. diverse collections.
  385. (@)  This sign indicates "small" sites--each site so marked has only one
  386. or two Apple-related files.
  387. (?)  Did not answer ping requests
  388.  
  389. Archives of C.S.A2 Newsgroups:
  390. ===============================
  391. wuarchive.wustl.edu      /usenet/comp.sources.apple2 (complete!)
  392.                          /usenet/comp.binaries.apple2
  393. ftp.tohoku.ac.jp         /pub/news/comp.binaries.apple2
  394. hp4nl.nluug.nl           /pub/newsarchive/comp/sources/apple2 (incomplete)
  395. mcsun.eu.net             /pub/newsarchive/comp/sources/apple2 (incomplete)
  396. nic.funet.fi             /pub/archive/comp.sources.apple2 (complete?)
  397. relay.cs.toronto.edu     /pub/lists.1989 (1989 only)
  398.  
  399.  
  400.  
  401. FTP: watsun.cc.columbia.edu   /kermit/a (the OFFICIAL source for Kermit)
  402.  
  403. Non-USENET readers wanting files should look at the e-mail addresses in the
  404. "What is comp.sys.apple2" section.  Or try finding archives thru gopher (i.e.
  405. umich).
  406.  
  407. ::::::::::::::::::::::::::::::::::::::::::::::::
  408. :  Q#5   How can I find a particular program?  :
  409. ::::::::::::::::::::::::::::::::::::::::::::::::
  410.  
  411. There is a program called archie that allows you to search many archives
  412. quickly.  Look for the program 'archie' or 'xarchie' at your site, or (if you
  413. are on the internet) you can telnet (login as archie) to:
  414.  
  415. archie.rutgers.edu   128.6.18.15   (Rutgers University)
  416. archie.unl.edu       129.93.1.14   (University of Nebraska in Lincoln)
  417. archie.ans.net       147.225.1.2   (ANS archie server)
  418. archie.mcgill.ca     132.206.2.3   (Canada server, original archie site)
  419. archie.au            139.130.4.6   (Australian server)
  420. archie.funet.fi      128.214.6.100 (European server in Finland)
  421. archie.doc.ic.ac.uk  146.169.11.3  (UK/England server)
  422. archie.wide.ad.jp    133.4.3.6     (Japanese server)
  423.  
  424. ###################################################
  425. #  Q#6   What archivers do I need to know about?  #
  426. ###################################################
  427.  
  428. :::::::::::::::::::
  429. :  Q#7   BinSCII  :
  430. :::::::::::::::::::
  431.  
  432. BinScii converts binary files to text files and back.  Binary files contain
  433. pictures, computer programs, etc.  Text files usually contain human readable
  434. text (like this file), but a BinSCII file just looks like a jumble of letters
  435. and symbols. A BinScii text file is larger than the original binary file. 
  436. Binscii is needed to transfer programs across the network when there is no
  437. binary mode (like the Usenet newsgroups and e-mail).
  438.  
  439. When turning a binary file into text, BinSCII will output a series of files. 
  440. Each file contains a segment of the original program encoded in BinSCII
  441. format.  These segments are small enough to be posted or e-mailed without
  442. clogging the network. (Actually, they are usually posted 3 at a time to save
  443. bandwidth).
  444.  
  445. When re-creating a binary file from the BinScii segments, all one has to do is
  446. collect ALL the segments and run them through BinScii.  Each segment has a
  447. header that tells BinScii which segment it is.  BinScii is intelligent enough
  448. to wade through all extraneous text (i.e. newsgroup headers, etc) and find
  449. the segments.  It does not matter what order the segments are in, and the
  450. segments can be in different files.  The only thing you have to remember is
  451. that BinScii does not check to see if ALL of the segments have been accounted
  452. for.  If there are segments missing, the program will not work, or more
  453. likely you will get a 'file corrupted' error when unshrinking.
  454.  
  455. FTP: apple2.archive.umich.edu /apple2/8bit/archivers/binscii.exe
  456.  
  457. GS users can use GSCII+, an NDA version of Binscii.  GSCII+ can also
  458. encode/decode several other formats.
  459.  
  460. FTP: apple2.archive.umich.edu /apple2/gs/archivers/gscii.bsc
  461.  
  462.      [ Note that most files on the network are NuFX archives that have been
  463. BinSCII'ed so they can be posted.  After running Binscii, you will still need
  464. to run ShrinkIt on the resulting file.]
  465.  
  466. For those of us on Unix boxes who are able to transfer binary files to our
  467. Apple ][, SciiBin can reduce the time spend downloading. It is a decode-only
  468. version of BinSCII written in C.  The idea is that you compile this on your
  469. Unix box, and run your BinScii files from comp.binaries.apple2 through it. It
  470. will re-create the original (smaller) file.  This works great if there is a
  471. NuFX archive in the BinSCII file, but can cause problems if BinSCII was
  472. applied directly to ProDos executable files. (Unix has no way of storing the
  473. ProDos file type and aux type of a file, so they simply get lost. See the
  474. section on filetypes.
  475.  
  476. FTP: wuarchive.wustl.edu /?
  477.  
  478. If you need a Unix BinSCII encoder, Bsc will do the trick. The source code is
  479. in "Apple archive format".
  480.  
  481. FTP: cco.caltech.edu /pub/apple2/source/bsc.aaf ?
  482.  
  483. FTP: apple2.archive.umich.edu /apple2/unix/bsc.aaf
  484.  
  485. ::::::::::::::::::::::::::::::::::::::
  486. :  Q#8   ShrinkIt and NuFX archives  :
  487. ::::::::::::::::::::::::::::::::::::::
  488.  
  489. ShrinkIt is an Apple II program which takes one or more Apple II ProDOS files
  490. or disks and 'archives' them into a single file (called a NuFX archive).  It
  491. also stores all the vital ProDos information, such as filetype and auxtype. 
  492. Usually these files are denoted by putting a ".SHK" extension on the archive.
  493. ShrinkIt can also shrink an entire disk into a file (extension ".SDK"), but
  494. this is only used when the disk is not ProDos.   ShrinkIt is also a menu
  495. driven utility that compresses/extracts, but also formats disks, copies
  496. files, etc. ShrinkIt can also extract programs with Binary II headers, and
  497. files in BLU archives.
  498.  
  499. FTP: apple2.archive.umich.edu /apple2/8bit/archivers/shrinkit.3.3.exe.bsc
  500.  
  501. GShk is a version of ShrinkIt for GS computers.  This is even more of a wonder
  502. utility in that it extracts many different archive types (Unix compress, PC
  503. Arc, Mac StuffIt, Apple Single).  Files encoded with GShk are usually smaller
  504. than those encoded with ShrinkIt, but can still be extracted with ShrinkIt
  505. (except files with resource forks).
  506.  
  507. ShrinkIt+ and UnShrinkIt+ are programs for the Apple II+ that allow an Apple
  508. II+ user to create NuFX archives and extract from them. Autounshrink is a
  509. NuFX extractor that attempts to recover from errors within an NuFX file.
  510.  
  511. :::::::::::::::::::::::
  512. :  Q#9   Executioner  :
  513. :::::::::::::::::::::::
  514.  
  515. Executioner was the standard program previous to BinSCII for converting Apple
  516. II files into text to be mailed/posted.  It is no longer considered the
  517. standard for most transferals of Apple II binary files.  Presently,
  518. Executioner is typically only used to distribute BinSCII.  Some older files
  519. in the various archives may also be encoded with this program. Many of them
  520. will not work under ProDos.
  521.  
  522. To translate an Executioner text file to an Apple II file required that you
  523. delete the mail headers/trailers, translated the newlines into carriage
  524. returns, download the file to your Apple II and from Applesoft Basic, type
  525. the command 'EXEC <filename>' where <filename> is the name of the file you
  526. downloaded.
  527.  
  528. ::::::::::::::::::::::::::::::::::::::
  529. :  Q#10  Apple Archive Format (aaf)  :
  530. ::::::::::::::::::::::::::::::::::::::
  531.  
  532. Apple Archive Format was invented as a standard way to post source code to
  533. comp.sources.apple2. The C and Basic source code to aaf unpackers are
  534. available on the various FTP sites, in aaf format. Fortunately, files in aaf
  535. format can be turned back into source code with a simple text editor. Just
  536. break the file up into component files and remove the first character of each
  537. line.
  538.  
  539. FTP: apple2.archive.umich.edu /apple2/unix/?.aaf
  540.  
  541. ::::::::::::::::::::::::::::::::
  542. :  Q#11  Net standard formats  :
  543. ::::::::::::::::::::::::::::::::
  544.  
  545. There are several formats that are used widely on the Internet.  The most
  546. common in FTP sites are tar (.tar) and compress (.Z). To undo a Tape Archive,
  547. type 'tar -xvf filename.tar'.  To undo a compress, type 'uncompress
  548. filename.Z'.  Since tar does not make the file smaller, and compress can only
  549. compress 1 file, many times you will find files that are 'tarred an
  550. feathered'.  They have a '.tar.Z' extension.  Just run uncompress then un-tar
  551. the result.
  552.  
  553. To distribute binaries on the net, most other groups use uuencode (c.b.a2 uses
  554. BinSCII). To return them to normal, type 'uudecode filename'.  Note that
  555. uuencoded things were not meant to be split up and posted, so when getting
  556. multiple parts, you will have to paste them together and run them through
  557. uudecode. (BinSCII is a lot smarter, that's why we use it on c.b.a2.)  
  558. BinSCII is better because 1) It stores the ProDos filetype, etc.  2) It
  559. splits the file into 12K chunks, 3) It does a CRC checksum on each chunk.
  560.  
  561. Most of these 'Unix' standard formats are available on the Apple.  For
  562. example, ShrinkIt GS will uncompress files, there is a uudecode for the //e,
  563. and Tar is available as a GS shell executable.
  564.  
  565. FTP: apple2.archive.umich.edu /apple2/8bit/util/dearc.?
  566.  
  567. :::::::::::::::::::::::::::::::::::::::::::::::
  568. :  Q#12  A quick note about ProDos filetypes  :
  569. :::::::::::::::::::::::::::::::::::::::::::::::
  570.  
  571. ProDos keeps some information about a file's type.  Files can be text (TXT),
  572. binary (BIN), executable (SYS), fonts (FON), etc. Most other file systems do
  573. not have a place to store this information, so it may get 'lost' when you
  574. upload the file.  Similarly, when you download a file, you may not know the
  575. file type. Most comm programs will use some default.  For NuFX archives, this
  576. is not a big deal, since you can still unpack an archive if the filetype is
  577. wrong (and the archive stores the filetype of the files inside the archive).
  578. For other files, you may need to change the file's type.  One utility I
  579. recommend is File Attribute Zapper II.
  580.  
  581. FTP: apple2.archive.umich.edu /apple2/8bit/util/fazz.2.3.bsq
  582.  
  583. Program        Format   Author
  584. ---------------------------------------------------------------------------
  585. Nulib v3.21      C      Andy McFadden  (fadden@uts.amdahl.com)
  586. SciiBin v3.10    C      Marcel Mol, Dave Whitnet, Bruce Kahn
  587. Bsc v1.2         C      Neil Parker
  588. Executioner      A      Glen Bredon
  589. BinSCII v1.0.3   A      David Whitney  (davewh@microsoft.com)
  590. ShrinkIt v3.3    A      Andy Nicholas  (shrinkit@apple.com)
  591. (Un)ShrinkIt+    A      Andy Nicholas  (shrinkit@apple.com)
  592. AutoUnShrink     A      Andy Nicholas  (shrinkit@apple.com)
  593. GShk v1.1        G      Andy Nicholas  (shrinkit@apple.com)
  594. GSCII+ 2.3.1     G      Darek Taubert  (dat33228@uxa.cso.uiuc.edu)
  595. Format:
  596.   C - Distributed as source code written in C.
  597.   A - Executable, runs on most Apple //s.
  598.   G - Executable, runs on GS only.
  599.  
  600.      |Type| NuFX | Bin  | uuen-| com-  |.ZOO | Bin | LZH/| Stuff| ARC | Other|
  601. Program | |      | SCII | code | press |     | Hex | LHA | -It  |     |      |
  602. --------|-|------|------|------|-------|-----|-----|-----|------|-----|------|
  603. Binscii |e|      |   X  |      |       |     |     |     |      |     |      |
  604. Shrinkit|e|   X  |      |      |       |     |     |     |      |     |      |
  605. DeArc   |e|      |      |      |       |     |     |     |      |  D  |      |
  606. Angel[1]|e|      |      |      |   X   |  X  |     |  X  |      |  X  | .ZIP |
  607. GShk    |g|   X  |      |      |   D   |  D  |     |     |  D   |  D  |      |
  608. GSCII+  |g|      |   X  |   X  |       |     |  D  |     |      |     | .AAF |
  609. sscii   |x|      |   X  |   X  |       |     |  X  |     |      |     |      |
  610. PMPUnzip|x|      |      |      |       |     |     |     |      |     | .ZIP |
  611. LHext   |x|      |      |      |       |     |     |  D? |      |     |      |
  612. BSC     |c|      |   E  |      |       |     |     |     |      |     |      |
  613. Nulib   |c|   X  |      |      |       |     |     |     |      |     |      |
  614. SciiBin |c|      |   D  |      |       |     |     |     |      |     |      |
  615.  
  616. (Key:   E = Encode only,    D = Decode only,  X = Encode and Decode)
  617. (Type:  e = Apple //e,  g = GS Only,  x = GS EXE file, c = C Source code)
  618.  
  619. [1] Angel is pretty Buggy, but it's worth a try.
  620.  
  621.  
  622.  
  623.  
  624. #############################################
  625. #  Q#13  What do the file extensions mean?  #
  626. #############################################
  627.  
  628. Many times, people put filename extensions (extra characters at the end of a
  629. filename) to denote what type of file it is. Please note that these are just
  630. accepted standards.  If a file does not indicate it's type, see the section
  631. on file formats.  The following is a table of some common filename
  632. extensions.  See the section on archivers for programs that will deal with
  633. these files.
  634.  
  635.  
  636.  
  637. Extension   What is it?  (What program do I use?)
  638. ---------  ---------------------------------------------------------------
  639.  .aaf   [TEXT] Apple Archive Format for source code (aaf.unpacker)
  640.  .ACU   Applelink Conversion Utility (Shrinkit)
  641.  .ARC   ARC Archive (IBM ARC, GS Shrinkit, //e Angel or DeArc2E)
  642.  .CPT   Compactor Pro archive (Compactor Pro on a Mac only)
  643.  .BSC   BinScii file. [TEXT]  (BinScii)
  644.  .BSQ   BinSCII'ed NuFX file. [TEXT]  (BinScii, Shrinkit on the result)
  645.  .BXY   NuFX archive with a Binary II header.  (Shrinkit)
  646.  .BNY   BLU archive. (Shrinkit)
  647.  .BQY   NuFX or Binary II  with BLU header. (Shrinkit)
  648.  .BNX   NuFX with BLU header. (Shrinkit)
  649.  .exe   Executioner file [TEXT]. May only work in DOS 3.3.
  650.  .GIF   Graphics Interchange Format: Compressed picture.
  651.         (IIGIF for //e, many programs for all other computers)
  652.  .HQX   Mac BinHex file. [TEXT] (BinHex on Mac or GSCII+)
  653.  .JPG   Newer graphics format. (only Unix/IBM/etc viewers)
  654.  .JPEG  Newer graphics format. (only Unix/IBM/etc viewers)
  655.  .LZH   LZH Archive (IBM/Amiga LZH program, //e Angel)
  656.  .LHA   LHA Archive (IBM/Amiga LZH program, //e Angel)
  657.  .QQ    BLU archive.  (Shrinkit)
  658.  .SEA   Self-extracting archive (Might be Mac, Might be Shrinkit archive)
  659.  .SIT   Mac StuffIt archive. (Stuffit on Mac or GS ShrinkIt)
  660.         GS Shrinkit will not decode StuffIt Deluxe files.
  661.  .SHK   NuFX archive. (Shrinkit)
  662.  .SDK   NuFX with a shrunk disk image. (Shrinkit)
  663.  .tar   Unix Tape Archive (Unix tar [with -xvf option, GS EXE tar])
  664.  .txt   [TEXT] An ASCII text file: usually english text.
  665.  .TIFF  Graphics format (GS SHR Convert)
  666.  .uu    Unix uuencode file [TEXT] (//e uudecode, Unix uudecode)
  667.  .ZOO   IBM Zoo Archive (GS Shrinkit or IBM ZOO program, //e Angel)
  668.  .ZIP   IBM Zip Archive (GS EXE Unzip, IBM PKUNZIP, Unix unzip, //e Angel)
  669.  .Z     Compressed file (GS Shrinkit, Unix uncompress, //e Angel)
  670.  
  671.  
  672.  
  673. All of these types, except the ones marked [TEXT] are BINARY files.  Binary
  674. files cannot be sent over e-mail, posted to the newsgroups or FTP'd in text
  675. mode.  You must FTP them in binary mode (see the section on FTP). You can
  676. also download them using kermit, X-,Y- or Z-Modem.
  677.  
  678. Generally, anything labeled as 'Archive' above will contain multiple files,
  679. and even subdirectories.  Most archives are also in compressed format.
  680.  
  681. Sometimes you will find multiple filename extensions.  Simply take the
  682. filename extensions apart one at a time and you should be able to reconstruct
  683. the original file. (i.e. somefile.bsq.tar.Z would mean: uncompress, untar,
  684. unbinscii, then unShrink to get the original file!)
  685.  
  686. ####################################################
  687. #  Q#14  How do I tell what kind of file this is?  #
  688. ####################################################
  689.  
  690. Here is a simple guide to help you identify a file.  You should always go by
  691. filename extension first, but not everybody uses those. In Unix, you can use
  692. the 'head' command to look at the first couple of lines of a file.  If it
  693. turns out to be a binary file, you may be in for a surprise.  You may want to
  694. use the Unix 'file' command to find out if it is a text file or not first. 
  695. Once you have identified the file, see the section on filename extensions for
  696. how to deal with it.
  697.  
  698. If there are lines in the file that look like this (there can be other text
  699. before it--search for 'FiLeStArT'):
  700.  
  701. FiLeStArTfIlEsTaRt
  702. ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789()
  703. GBINSCII        AQhmAAAAA8)4MIAI02DA9ARMQEDtAQhmAIVZ
  704. gYITA6u7xADA0MjM3YTNBlDOENkQwYURzITM2UDN5gzNDJUQGVERyEDM1QzM4cjN
  705. CFUOFR0QxAjR0MjM3YTNBlDOENkQwAQRzITM2UDN5gzNDJUQGVERyEDM1QzM4cjN
  706. ..
  707.  
  708. then you've got something encoded by BinSCII. You must decode _all_ the parts
  709. using BinSCII before attempting to extract using ShrinkIt.
  710.  
  711. On the other hand, if you have a binary file which resembles:
  712.  
  713. NuFilei][![/#NuFX_<:c[[[ H`F-fGSCII~[
  714. cRJ0)fNN^P)3'A2p6SF6X#GPd<9#'LC^08N7n\NB7Dd!eMN&eYX0Am=fXp
  715. d@PAsp7rh`I'NS0ALAfi2)2ysGEQ$k9CP%L9
  716. ...
  717.  
  718. then you have a NuFX file (note the key words NuFile and NuFX).  You should be
  719. able to extract the files it contains using ShrinkIt.
  720.  
  721. On the third hand, if you have a text file which resembles:
  722.  
  723. begin 666 nonsense.bny
  724. M4W5N3U,@4F5L96%S92 T+C$@\%-$4U0V,"D@(S@Z(%1U92!/8W0@.2 Q,CHS
  725. M...3HT.2!%1%0@,3DY, HT
  726.  
  727. then you have a uuencoded file.
  728.  
  729. On another hand, if you have a text file which begins with
  730.  
  731. (This file must be converted with BinHex 4.0)
  732. :$&4)48C28N0&,P009!"6593K8dP8)3%!!!#L@!!!!!!Qie009#%!!3!!SPKb6'&
  733. e!3!!!!!!!!!#!!P8D'8J4QpbBf9P)IN33)(4$N#"d4K!JG%S!!!!!`!'VfJ!"VP
  734.  
  735. then you have a BinHex file. The GSCII+ NDA by Derek Taubert decodes BinHex
  736. files on an Apple IIGS. You can also use a variety of macintosh programs to
  737. do the decoding. There is also a Unix implementation of BinHex called mcvert.
  738.  
  739. On one more hand, if you have a text file which resembles:
  740.  
  741. CALL-151
  742. E00:38 A5 FF D0 32 D8 20 8E FD AD 30 BF 8D 6A 0E 20 00 BF C7 6D 0E 0D 80 02
  743. E18:D0 1D 20 00 BF C5 69 0E B0 15 AD 81 02 29 0F AA E8 8E 80 02 A9 2F 8D 81
  744.  
  745. and more lines like that, followed by a bunch of lines that look like:
  746.  
  747. A90885A420732090242039FB2058FCA200BD9220F00620EDFDE8D0F5200CFDA9
  748. 008DF2038DF3038DF4036CFCFFE6A4A5A4C96F90CFA9008DFCBFA9018DFDBFA0
  749. A90885A420732090242039FB2058FCA200BD9220F00620EDFDE8D0F5200CFDA9
  750.  
  751. then you have an Executioner file.
  752.  
  753. ======================================================================
  754. This FAQ is available on-line at apple2.archive.umich.edu (see FTP)
  755. CopyLeft 1994 by Dan DeMaggio. Non-profit distribution encouraged.
  756.                   Mail me at: dmag@umich.edu
  757. -- 
  758. dmag@umich.edu | When laws are outlawed,      | Ono-Sendai: the best
  759. Dangerous  Dan | only outlaws will have laws. | Sim Stim decks
  760. -- 
  761. dmag@umich.edu | When laws are outlawed,      | Ono-Sendai: the best
  762. Dangerous  Dan | only outlaws will have laws. | Sim Stim decks
  763.  
  764.